home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_UMINNgopher.idb / usr / freeware / src / gopher_1.12 / doc / INSTALL.z / INSTALL
Text File  |  1997-09-09  |  4KB  |  120 lines
  1. $Id: INSTALL,v 1.1 1995/10/03 04:07:27 drich Exp $
  2.  
  3. Installation Instructions for Unix Gopher.
  4. ------------------------------------------
  5.  
  6. Almost all configuration is now in two files, Makefile.config and conf.h.
  7.  
  8. Some of the more important parameters in Makefile.config are
  9.  
  10.    PREFIX       The base pathname where everything is installed.
  11.    CLIENTDIR    Where the client (gopher) is installed.
  12.    CLIENTLIB    Where the client helpfile is installed
  13.    SERVERDIR    Where the server (gopherd) and
  14.                 the server configuration file (gopher.conf) is installed
  15.    MAN1DIR      Where the man pages for gopher are installed.
  16.    MAN8DIR      Where the man pages for gopherd are installed.
  17.  
  18. Some of the more important paramerters in conf.h are:
  19.  
  20.    CLIENT1_HOST, CLIENT2_HOST  The host(s) to contact first.
  21.    CLIENT1_PORT, CLIENT2_PORT  The port(s) to contact first.
  22.  
  23. Check the Libraries for your specific system, HP, Umax, SCO and others
  24. will need to make some changes. Specifically for OTHERLIBS.  Ultrix
  25. users note that you'll need to change -lcurses to -lcursesX for
  26. CLIENTLIBS.
  27.  
  28. If you're making a gopher server and are interested in full-text
  29. indexes, see the section on full-text searching in this file *now*.
  30.  
  31.  
  32. If you want to make just the client type:
  33.  
  34.    make client
  35.  
  36. If you want to make just the server type:
  37.  
  38.    make server
  39.  
  40. If you want to make everything, just type:
  41.  
  42.    make
  43.  
  44. If you want to install everything, type:
  45.  
  46.    make install.
  47.  
  48. If you want to install just the client, type:
  49.  
  50.    (cd gopher; make install)
  51.  
  52. If you want to install just the server, type:
  53.  
  54.    (cd gopherd; make install)
  55.  
  56.  
  57. Installing external programs for the gopher client
  58. --------------------------------------------------
  59.  
  60. The gopher client depends on certain external programs for some
  61. functionality.  Most of these will be present on any good unix system.
  62. However you may need to install the following:
  63.  
  64.   For tn3270 connections you'll need tn3270 or a version of telnet
  65. that understands tn3270 control streams.
  66.  
  67.   For downloading in the client you'll need two distributions, kermit
  68. and zmodem.  The binaries are "kermit", "sz", "sb", and "sx".
  69.  
  70.   To view metamail documents you'll need mm.tar.Z available from
  71. thumper.bellcore.com.
  72.  
  73.   To view graphics you'll X windows and xloadimage or xv or any other
  74. generic graphics program.
  75.  
  76.   To listen to sounds you can use the "play" command on SunOS or the
  77. play command in the misc directory for the NeXT
  78.  
  79.  
  80. Full Text Indexing Setup for NeXTs (NeXTos 2.0, 2.1, 2.2)
  81. ---------------------------------------------------------
  82.  
  83. First get the libtext and btree libraries.  (Available as a separate
  84. tar file called NeXTtext.tar.Z).  The files libbtree.a and libtext.a
  85. are in this tar file, along with two directories "btree" and "text".
  86. Copy the library (.a) files to /usr/local/lib and type 
  87.  
  88.    ranlib /usr/local/lib/libbtree.a
  89.    ranlib /usr/local/lib/libtext.a
  90.  
  91. Then copy the directories btree and text into /usr/include
  92.  
  93.  
  94. Full Text Indexing Setup for WAIS
  95. ---------------------------------
  96.  
  97. First get the wais distribution.  If you don't have wais, ftp to
  98. "think.com" and get /wais/wais-8-b5.tar.Z  Untar this and edit the
  99. makefiles appropriate for your system.
  100.  
  101. After you untar the distribution, go into the top level WAIS directory
  102. and make the distribution.  Refer to the instructions in the WAIS
  103. distribution.
  104.  
  105. "make lib"
  106. "make ir"
  107. "make bin"
  108.  
  109. Or just type make if you want the whole WAIS thing.
  110.  
  111. Now go to the top level of the gopher distribution and do the following:
  112.  
  113. % cd {GopherSrc}
  114. % ln -s {WaisTop}/ir .
  115. % ln -s {WaisTop}/ui .
  116. % ln -s {WaisTop}/bin .
  117.  
  118. If you've compiled an older version of gopherd, make sure to type
  119. "make clean" first.
  120.